KEY 관리

마스터 관리자가 고객사(테넌트)별로 제품 라이선스 KEY를 발급하고 관리하는 메뉴입니다. 발급한 KEY는 고객에게 전달하며, KEY의 등록·활성화는 고객사가 각 제품의 콘솔에서 직접 수행합니다. 본 메뉴는 최고 마스터 관리자(SCMASTER) 전용입니다.

발급 시 제품을 선택하면 해당 제품에 맞는 입력 항목이 표시됩니다. 현재는 SDF 제품을 지원하며, 지원 제품은 순차적으로 추가될 예정입니다.

기본 화면 구성

마스터 관리자 가이드의 구독 화면은 두 개의 탭으로 구성됩니다.

구독 탭: 테넌트별 구독 추가·전환·해제를 관리합니다.
KEY 관리 탭: 고객사별 제품 라이선스 KEY를 발급·조회·폐기합니다. (본 문서에서 설명)

구독 > KEY 관리 탭을 클릭하면 발급된 KEY 목록 화면이 열립니다.

⚠️ KEY 관리 탭은 최고 마스터 관리자(SCMASTER)만 접근·발급·폐기할 수 있습니다. 다른 관리자 등급에는 노출되지 않습니다.

KEY 관리 목록

발급된 KEY를 고객사 단위로 한눈에 확인하는 목록입니다.

컬럼	설명
회사	KEY를 발급한 고객사(테넌트) 이름
제품	발급한 제품 (예: SDF)
구독 상태	KEY의 현재 상태 (유효 / 만료 / 미활성 / 폐기)
구독 기간	KEY의 사용 기간 `YYYY.MM.DD ~ YYYY.MM.DD`
발급된 날짜	마스터가 KEY를 발급한 날짜
등록일	고객사가 제품 콘솔에서 KEY를 등록한 날짜 (미등록 시 `미등록`)

구독 상태 값

유효: 현재 사용 기간 내에서 정상 동작하는 KEY입니다.
만료: 사용 기간이 지나 더 이상 유효하지 않은 KEY입니다.
미활성: 시작일이 아직 도래하지 않은 KEY입니다. 미래 시작일로 사전 발급한 경우이며, 시작일이 되면 자동으로 유효로 전환됩니다.
폐기: 마스터 관리자가 KEY를 폐기한 상태입니다. 만료일이 남아 있어도 해당 고객사는 제품을 사용할 수 없습니다.

💡 목록에는 KEY가 정상 발급된 고객사만 표시됩니다. 아직 발급하지 않은 고객사는 나타나지 않습니다.

💡 폐기한 KEY도 목록에서 사라지지 않고 폐기 상태로 계속 표시됩니다.

발급된 KEY가 하나도 없으면 발급된 라이선스 KEY가 없습니다. 안내가 표시됩니다.

라이선스 KEY 발급

고객사별로 제품 라이선스 KEY를 새로 발급합니다.

전제조건

대상 고객사(테넌트)가 이미 생성되어 있어야 합니다.
해당 고객사에 발급하려는 제품의 구독이 활성 상태여야 발급 대상 목록에 표시됩니다.

⚠️ 회사(테넌트)가 없거나 해당 제품 구독이 없는 고객사에는 KEY를 발급할 수 없습니다.

사용 방법

KEY 관리 탭 상단의 [라이선스 KEY 발급] 버튼을 클릭합니다.
회사를 선택합니다. (발급하려는 제품 구독이 활성인 고객사만 표시됩니다.)
제품을 선택합니다. 선택한 제품에 따라 입력 항목이 달라집니다. (현재 지원: SDF)
선택한 제품에 맞는 항목을 입력합니다. → 아래 제품별 설정 항목 참고
구독 기간의 시작일과 만료일을 선택합니다.
[KEY 발급] 버튼을 클릭합니다.

💡 시작일을 미래 날짜로 지정하면 KEY 상태가 미활성으로 발급됩니다. 계약 시작일에 맞춰 미리 발급해 둘 때 사용하며, 시작일이 되면 자동으로 유효로 전환됩니다.

💡 KEY를 폐기한 고객사도 발급 대상 목록에 계속 표시되므로, 폐기 후 곧바로 새 KEY를 발급할 수 있습니다.

⚠️ 다음 경우 발급이 차단되고 사유가 안내됩니다.

시작일이 만료일보다 뒤일 때
수량 항목이 1 미만일 때
등록되지 않은 회사를 대상으로 할 때

제품별 설정 항목

발급 시 선택한 제품에 따라 입력 항목이 달라집니다. 공통 항목은 회사 · 제품 · 구독 기간(시작일~만료일)이며, 그 외 수량 항목은 제품별로 다릅니다.

SDF 선택 시

항목	필수	설명
업무시스템 수	필수	라이선스에 포함할 업무시스템 수. 1 이상.
식별자 수	필수	라이선스에 포함할 식별자 수. 1 이상.
SDF APP 수	필수	라이선스에 포함할 SDF APP 수. 1 이상.

💡 다른 제품이 추가되면, 제품 선택 시 해당 제품에 맞는 설정 항목이 이 자리에 표시됩니다.

발급 완료 및 KEY 전달

발급이 완료되면 라이선스 KEY 발급 완료 화면이 표시됩니다.

생성된 라이선스 KEY 문자열이 표시됩니다.
[키 복사] 아이콘을 클릭하면 KEY가 클립보드로 복사되고, 아이콘이 체크 표시(복사됨)로 바뀝니다.
대상 회사·제품·수량·구독 기간의 계약 요약이 함께 표시됩니다.
[확인] 버튼을 클릭하면 완료 화면이 닫히고, KEY 관리 목록에 새 KEY가 반영됩니다.

⚠️ 발급된 KEY는 최초 1회만 확인할 수 있습니다. 완료 화면을 닫으면 다시 표시되지 않으므로, 반드시 [키 복사]로 복사하여 안전한 곳에 보관한 뒤 고객에게 전달하세요.

KEY 전달 이후: 고객사 관리자는 전달받은 KEY를 해당 제품의 고객 콘솔에서 직접 등록·활성화합니다. 등록·활성화는 본 메뉴의 범위가 아닙니다.

KEY 상세 확인

목록에서 행을 클릭하면 해당 고객사의 KEY 상세 정보가 오른쪽 드로어로 열립니다.

계약 내용(제품별 수량 항목), 구독 기간, 구독 상태, 발급된 날짜, 등록일을 확인할 수 있습니다.
등록일은 고객사가 제품 콘솔에서 KEY를 등록하면 표시됩니다. 아직 등록 전이면 미등록으로 나타납니다.
구독 상태가 폐기인 KEY는 폐기된 날짜와 폐기 사유가 추가로 표시됩니다.
상세 화면 하단의 [KEY 폐기] 버튼은 폐기할 수 있는 KEY에만 표시됩니다. → 아래 KEY 폐기 참고

⚠️ 보안을 위해 평문 KEY 문자열은 상세 화면에서 다시 표시되지 않습니다. KEY 확인은 발급 완료 화면에서의 1회만 가능합니다.

KEY 폐기

발급한 KEY를 무효화합니다. 폐기하면 해당 고객사는 즉시 제품 사용이 차단되며, KEY는 목록에서 사라지지 않고 폐기 상태로 남습니다.

폐기할 수 있는 KEY

[KEY 폐기] 버튼은 고객사가 제품 콘솔에 등록을 마친 KEY(등록일이 있는 KEY)에만 표시됩니다. 다음 KEY에는 버튼이 표시되지 않습니다.

등록일이 미등록인 KEY — 고객이 아직 등록하지 않아 사용 중인 KEY가 아닙니다.
이미 폐기 상태인 KEY — 폐기는 한 번만 수행합니다.

사용 방법

목록에서 대상 고객사 행을 클릭해 상세 드로어를 엽니다.
[KEY 폐기] 버튼을 클릭하면 라이선스 KEY 폐기 확인 창이 열립니다.
확인 창에서 대상 회사 · 제품 · 구독 기간이 맞는지 확인합니다.
폐기 사유를 입력합니다. 필수 항목이며, 입력하기 전에는 [KEY 폐기] 버튼이 비활성 상태입니다.
[KEY 폐기] 버튼을 클릭합니다. 폐기가 완료되면 완료 알림이 표시되고 목록의 구독 상태가 폐기로 바뀝니다.

⚠️ 폐기는 취소할 수 없습니다. 폐기 시 해당 고객사의 제품 사용이 즉시 차단되며, 복구는 새 KEY 발급 → 고객사 재등록으로만 가능합니다.

💡 KEY 폐기는 최고 마스터 관리자(SCMASTER)만 수행할 수 있습니다.

폐기 후 표시

위치	표시 내용
KEY 관리 목록	행이 유지되며 구독 상태가 `폐기`로 표시됩니다.
KEY 상세 드로어	`폐기된 날짜` · `폐기 사유`가 표시되고, `[KEY 폐기]` 버튼은 사라집니다.
고객사 관리자 홈	해당 제품 카드가 `폐기` 배지와 `라이선스 KEY가 폐기되어 서비스 이용이 중지되었습니다. 관리자에게 문의하거나 새 KEY를 등록해주세요` 안내로 바뀌며, 구독 기간·잔여 기간은 표시되지 않습니다.

📌 폐기된 날짜와 폐기 사유는 현재 제품(SDF)에서 값을 제공하지 않아 -로 표시됩니다. 제품 연동이 반영되면 폐기 시 입력한 사유와 폐기 일시가 그대로 표시됩니다.

목차​

기본 화면 구성​

KEY 관리 목록​

라이선스 KEY 발급​

제품별 설정 항목​

SDF 선택 시​

발급 완료 및 KEY 전달​

KEY 상세 확인​

KEY 폐기​

목차